[Chapter 4] 4.2 Verbose (-v)
Author: Bryan Costales & Eric Allman
Date: 1999-01-06T18:33:24Z

#

| Chapter 4 How to Run sendmail |

## 4.2 Verbose (-v)

The `-v` command-line switch tells sendmail to run in verbose mode. In that mode, sendmail prints a blow-by-blow [4] description of all the steps it takes in delivering a mail message. To watch sendmail run in verbose mode, send mail to yourself as you did in Section 1.4, "Run sendmail by Hand", but this time add a `-v` switch:

> [4] Verbose mode is actually far more powerful than we've shown here.

>     % /usr/lib/sendmail -v you < sendstuff

The output produced shows that sendmail delivers your mail locally:

>     you... Connecting to local...
>     you... Sent

When sendmail forwards mail to another machine over a TCP/IP network, it communicates with that other machine using a protocol called SMTP (Simple Mail Transfer Protocol). To see what SMTP looks like, run sendmail again, but this time, instead of using `you` as the recipient, give sendmail your address on another machine.

>     % /usr/lib/sendmail -v you@remote.domain < sendstuff

The output produced by this command line will look similar to the following:

>     you@remote.domain... Connecting to remote.domain via smtp...
>     220-remote.Domain Sendmail 8.6.12/8.5 ready at Fri, 13 Dec 1996 06:36:12 -0800
>     220 ESMTP spoken here
>     >>> EHLO here.us.edu
>     250-remote.domain Hello here.us.edu, pleased to meet you
>     250-EXPN
>     250-SIZE
>     250 HELP
>     >>> MAIL From:<you@here.us.edu>
>     250 <you@here.us.edu>... Sender ok
>     >>> RCPT To:<you@remote.domain>
>     250 <you@remote.domain>... Recipient ok
>     >>> DATA
>     354 Enter mail, end with "." on a line by itself
>     >>> .
>     250 GAA20115 Message accepted for delivery
>     you@remote.domain... Sent (GAA20115 Message accepted for delivery)
>     Closing connection to remote.domain
>     >>> QUIT
>     221 remote.domain closing connection

The lines that begin with numbers and the lines that begin with `>>>` characters constitute a record of the SMTP conversation. We'll discuss those shortly. The other lines are sendmail on your local machine telling you what it is trying to do and what it has successfully done:

>     you@remote.domain... Connecting to remote.domain via smtp...
>     ...
>     you@remote.domain... Sent (GAA20115 Message accepted for delivery)
>     Closing connection to remote.domain

The first line shows to whom the mail is addressed and that the machine `remote.domain` is on the network. The last two lines show that the mail message was successfully sent.

In the SMTP conversation your local machine displays what it is saying to the remote host by preceding each line with `>>>` characters. The messages (replies) from the remote machine are displayed with leading numbers. We now explain that conversation.

>     220-remote.Domain Sendmail 8.6.12/8.5 ready at Fri, 13 Dec 1996 06:36:12 -0800
>     220 ESMTP spoken here

Once your sendmail has connected to the remote machine, your sendmail waits for the other machine to initiate the conversation. The other machine says that it is ready by sending the number 220, a dash (to say that it has more to say), and its fully qualified hostname (the only required information). If the other machine is running sendmail, it also says the program name sendmail and the version. It also states that it is ready and gives its idea of the local date and time.

The second line also starts with a 220, but that 220 is not followed by a dash. A dash means that more lines will follow, and the absence of a dash means that this is the last line. The "ESMTP spoken here" means that the remote site understands the Extended SMTP protocol. If the other machine were running V8.7 or later sendmail, the ESMTP would precede `Sendmail` in the first line, and there would be no second line.

If sendmail waits too long for a connection without receiving this initial message, it prints "Connection timed out" and queues the mail message for later delivery.

Next the local sendmail sends (the `>>>`) the word `EHLO`, for Extended Hello, and its own hostname:

>     >>> EHLO here.us.edu
>     250-remote.domain Hello here.us.edu, pleased to meet you
>     250-EXPN
>     250-SIZE
>     250 HELP

The E of the `EHLO` says that the local sendmail speaks ESMTP too. The remote machine replies with `250` and the acknowledgment that your hostname is acceptable, then lists the ESMTP services that it supports.

One problem that could occur is your machine sending a short hostname ("here") in the `EHLO` message. This would cause an error because the remote machine wouldn't find `here` in its domain `remote.domain`. This is one reason why it is important for your sendmail to always use your machine's fully qualified hostname. A fully qualified name is one that begins with the host's name, followed by a dot, then the entire DNS domain.

If all has gone well so far, the local machine sends the name of the sender of the mail message:

>     >>> MAIL From:<you@here.us.edu>
>     250 <you@here.us.edu>... Sender ok

Here, that sender address was accepted by the remote machine.

Next the local machine sends the name of the recipient:

>     >>> RCPT To:<you@remote.domain>
>     250 <you@remote.domain>... Recipient ok

If the user `you` were not known on the remote machine, it would reply with an error of "User unknown." Here, the recipient is `ok`. Note that `ok` does not necessarily mean that the address is good. It can still be bounced later. The `ok` means only that the address is acceptable.

After the envelope information has been sent, your sendmail attempts to send the mail message (header and body combined).

>     >>> DATA
>     354 Enter mail, end with "." on a line by itself
>     >>> .

`DATA` tells the remote host to "get ready." The remote machine says to send the message, and the local machine does so. (The message is not printed as it is sent.) A dot on a line by itself is used to mark the end of a mail message. This is a convention of the SMTP protocol. Because mail messages may contain lines that begin with dots as a valid part of the message, sendmail doubles any dots at the beginning of lines before they are sent. [5] For example, consider when the following text is sent through the mail:

> [5] This is called the "hidden dot algorithm" and is documented in RFC821.

>     My results matched yours at first:
>     126.71
>     126.72
>     ...
>     126.79
>     But then the numbers suddenly jumped high, looking like
>     noise saturated the line.

To prevent any of these lines from being wrongly interpreted as the end of the mail message, sendmail inserts an extra dot at the beginning of any line that begins with a dot, so the actual text transferred is

>     My results matched yours at first:
>     126.71
>     126.72
>     ....                                                        note extra dot
>     126.79
>     But then the numbers suddenly jumped high, looking like
>     noise saturated the line.

The SMTP-server program running at the receiving end (for example, another sendmail) strips those extra dots when it receives the message.

The remote sendmail shows the queue identification number that it assigned to the mail it accepted:

>     250 GAA20115 Message accepted for delivery
>     >>> QUIT
>     221 remote.domain closing connection

The local sendmail sends `QUIT` to say it is all done. The remote machine acknowledges by closing the connection.

Note that the `-v` (verbose) switch for sendmail is most useful with mail sent to remote machines. It allows you to watch SMTP conversations as they occur and can help in tracking down why a mail message fails to reach its destination.

4.1 Become a Mode (-b) |  | 4.3 Debugging (-d)